home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / g_man / cat3 / standard / defrasterfont.z / defrasterfont
Encoding:
Text File  |  2002-10-03  |  5.4 KB  |  133 lines
  1.  
  2.  
  3.  
  4. ddddeeeeffffrrrraaaasssstttteeeerrrrffffoooonnnntttt((((3333GGGG))))                                            ddddeeeeffffrrrraaaasssstttteeeerrrrffffoooonnnntttt((((3333GGGG))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ddddeeeeffffrrrraaaasssstttteeeerrrrffffoooonnnntttt - defines a raster font
  10.  
  11. CCCC SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  12.      vvvvooooiiiidddd ddddeeeeffffrrrraaaasssstttteeeerrrrffffoooonnnntttt((((sssshhhhoooorrrrtttt nnnn,,,, sssshhhhoooorrrrtttt hhhhtttt,,,, sssshhhhoooorrrrtttt nnnncccc,,,,
  13.                         FFFFoooonnnnttttcccchhhhaaaarrrr cccchhhhaaaarrrrssss[[[[]]]],,,, sssshhhhoooorrrrtttt nnnnrrrr,,,, uuuunnnnssssiiiiggggnnnneeeedddd sssshhhhoooorrrrtttt rrrraaaasssstttteeeerrrr[[[[]]]]))))
  14.  
  15. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  16.      _n        expects the constant that you want to use as the identifier for
  17.               this raster font.  This constant is used as an index into a font
  18.               table. The default font, 0, is a fixed-pitch font with a height
  19.               of 15 and width of 9.  Font 0 cannot be redefined.
  20.  
  21.      _h_t       expects the maximum height (in pixels) for a character.
  22.  
  23.      _n_c       expects the number of characters in this font.
  24.  
  25.      _c_h_a_r_s    expects an array of character description structures of type
  26.               Fontchar.  The Fontchar structure is defined in <_g_l/_g_l._h> as:
  27.  
  28.                    typedef struct {
  29.                        unsigned short offset;
  30.                        Byte w, h;
  31.                        signed char xoff, yoff;
  32.                        short width;
  33.                    } Fontchar;
  34.  
  35.               ooooffffffffsssseeeetttt expects the element number of _r_a_s_t_e_r at which the bitmap
  36.               for this character starts.  The element numbers start at zero.
  37.  
  38.               wwww expects the number of columns in the bitmap that contain set
  39.               bits (character width).
  40.  
  41.               hhhh expects the number of rows in the bitmap of the character
  42.               (including ascender and descender).
  43.  
  44.               xxxxooooffffffff expects bitmap columns between the start of the character's
  45.               bitmap and the start of the character.
  46.  
  47.               yyyyooooffffffff expects the number rows between the character's baseline
  48.               and the bottom of the bitmap.  For characters with descenders
  49.               (e.g., _g) this value is a negative number.  For characters that
  50.               rest entirely on the baseline, this value is zero.
  51.  
  52.               wwwwiiiiddddtttthhhh expects the pixel width for the character. This value
  53.               tells the system how far to space after drawing the character.
  54.               (This value is added to the character position.)
  55.  
  56.      _n_r       expects the number of 16-bit integers in _r_a_s_t_e_r.
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ddddeeeeffffrrrraaaasssstttteeeerrrrffffoooonnnntttt((((3333GGGG))))                                            ddddeeeeffffrrrraaaasssstttteeeerrrrffffoooonnnntttt((((3333GGGG))))
  71.  
  72.  
  73.  
  74.      _r_a_s_t_e_r   expects a one-dimensional array that contains all the bit maps
  75.               (masks) for the characters in the font.  Each element of the
  76.               array is a 16-bit integer and the elements are ordered left to
  77.               right, bottom to top.  When interpreting each element, the bits
  78.               are left justified within the character's bounding box.
  79.  
  80.               The maximum row width for a single bitmap is not limited to the
  81.               capacity of a single 16-bit integer array element.  The rows of
  82.               a bitmap may span more than one array element.  However, each
  83.               new row in the character bitmap must start with its own array
  84.               element.  Likewise, each new character bitmap must start with
  85.               its own array element. The system reads the row width and
  86.               starting location for a character bitmap from the structures in
  87.               the _c_h_a_r_s array.
  88.  
  89. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  90.      ddddeeeeffffrrrraaaasssstttteeeerrrrffffoooonnnntttt defines a raster font.  To replace a raster font, specify
  91.      the index of the previous font as the index for the new font.  To delete
  92.      a raster font, define a font with no characters. Patterns, cursors, and
  93.      fonts are available to all windows when using multiple windows.
  94.  
  95. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  96.      charstr, cmov, font, getcpos, getdescender, getfont, getheight, strwidth
  97.  
  98. NNNNOOOOTTTTEEEE
  99.      This routine is available only in immediate mode.
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.